home *** CD-ROM | disk | FTP | other *** search
SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) NNNNAAAAMMMMEEEE SoftWindows 2.0 - The Insignia SoftWindows IBM-PC Emulation SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss2222 [-c cmd] [-term name] [-keymap name] [- toolkitoption] sssswwwwiiiinnnn2222 ddddoooossss6666 ddddoooossss6666nnnneeeetttt wwwwiiiinnnn3333 wwwwiiiinnnn3333nnnneeeetttt DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss is a software emulation of an IBM PC 486- compatible personal computer. It allows direct execution of DOS and MS-Windows applications on Unix Workstations. SoftWindows starts SoftWindows from the X Window System, Version 11 Release 4 or 5. SoftWindows can also use character-mode terminals for DOS use only. sssswwwwiiiinnnn2222 and ddddoooossss6666 are synonyms for SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss2222 wwwwiiiinnnn3333 is a shorthand for SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss2222 ----cccc """"wwwwiiiinnnn"""" ddddoooossss6666nnnneeeetttt is a shorthand for SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss2222 ----cccc """"cccc::::\\\\nnnnoooovvvveeeellllllll\\\\eeeetttthhhheeeerrrr"""" wwwwiiiinnnn3333nnnneeeetttt is a shorthand for SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss2222 ----cccc """"cccc::::\\\\nnnnoooovvvveeeellllllll\\\\eeeetttthhhheeeerrrr;;;; wwwwiiiinnnn"""" SoftWindows first checks the user's home directory for a ....sssswwwwiiiinnnn2222ccccoooonnnnffffiiiigggg file. If this file doesn't exist then SoftWindows will use the file ssssyyyyssss....sssswwwwiiiinnnn2222ccccoooonnnnffffiiiigggg in the SoftWindows installation directory to create a .swin2config in the user's home directory. Typically user configuration is performed via the SoftWindows menu interface. To avoid conflicts, a user's .swin2config file should not be edited directly while running SoftWindows. OOOOPPPPTTTTIIIIOOOONNNNSSSS The SoftWindows program accepts all of the standard X Toolkit command line options. The following options are commonly used with SoftWindows. See XXXX((((1111)))) for a complete list and description. ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y This option specifies the X server to use. ----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y This option specifies the location of the SoftWindows window. Only the X and Y offsets are relevant; width and height are ignored. Page 1 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) ----iiiiccccoooonnnniiiicccc This option indicates that _S_o_f_t_W_i_n_d_o_w_s should be placed on the display in icon form. ----cccc ccccoooommmmmmmmaaaannnndddd This option causes the specified command to be supplied as an initial command to DOS. So for example: SoftWindows2 -c win causes DOS to execute the command 'win' as soon as it boots. Semicolons should be used to seperate mutiple DOS commands; this will require the whole string in quotes: SoftWindows2 -c "c:\novell\ether; win" is how wwwwiiiinnnn3333nnnneeeetttt starts up the Novell session and runs Windows. ----tttteeeerrrrmmmm tttteeeerrrrmmmm----ttttyyyyppppeeee This option sets up SoftWindows in Dumb Terminal mode (see below). The parameter term-type should be one of the names in the term directory in the SoftWindows installation directory, unless -keymap is also used, when a Unix Terminal name can be used instead. ----kkkkeeeeyyyymmmmaaaapppp tttteeeerrrrmmmm----ttttyyyyppppeeee This option is used in SoftWindows' Dumb Terminal mode (see below). It allows the keyboard style to be set independently from the terminal type defined with -term. The parameter term-type should be one of the names in the term directory in the SoftWindows installation directory. RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS The _S_o_f_t_W_i_n_d_o_w_s program understands all of the core X Toolkit resource names and classes. See _X(_1) for more information. The appearance of the SoftWindows main window is governed by the PC video adapter emulation. The following resources affect the appearance of the SoftWindows menus and status line only. bbbbaaaacccckkkkggggrrrroooouuuunnnndddd ((((class BBBBaaaacccckkkkggggrrrroooouuuunnnndddd)))) Specifies the background color of the menus and status line. bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr ((((class BBBBoooorrrrddddeeeerrrrCCCCoooolllloooorrrr)))) Specifies the border color used for the menus and Page 2 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) status line. ffffoooonnnntttt ((((class FFFFoooonnnntttt)))) Specifies the font for displaying text in the menus and status line. ffffoooorrrreeeeggggrrrroooouuuunnnndddd ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd)))) Specifies the color for displaying text in the menus and status line. ttttiiiittttlllleeee ((((class TTTTiiiittttlllleeee)))) Specifies the window title for SoftWindows. This string may be used by the window manager when displaying this application. Certain resources can be defined in the X11 resource database for use by the window manager. These define whether window menu and accelerator keys are used by the window manager and thus if they are available to SoftWindows. PPPPOOOOIIIINNNNTTTTEEEERRRR UUUUSSSSAAAAGGGGEEEE The left mouse button is used to navigate SoftWindows menus and select commands. To activate a menu or select a command, move the pointer over the desired menu item and click the left button. The Attach Mouse command can be used to attach the mouse to SoftWindows, enabling DOS mouse drivers to be used. To detach the mouse from SoftWindows, simultaneously press Ctrl + Alt and click the middle mouse button (both buttons on a two-button mouse). (N.B. The Alt button on an HP-ITF keyboard is the EEEExxxxtttteeeennnndddd CCCChhhhaaaarrrr key). When the mouse pointer is attached in this way, it must be detached in order to access any other X11 window. FFFFOOOONNNNTTTTSSSS _S_o_f_t_W_i_n_d_o_w_s will check to see if the fonts required by the video adapter emulation are installed and available to the X server being used whenever it is run, and if these cannot be found it attempts to provide the X server with an appropriate set of fonts from the ffffoooonnnnttttssss directory in the SoftWindows installation directory. The list of servers currently supported in this way is: Page 3 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) _____________________________________________________________ _|X_1_1__S_e_r_v_e_r__T_y_p_e_________________________________|_F_o_n_t__S_o_u_r_c_e__| | | | |Sun X11/News on SunOS 4 and SunOS 5.1 and 5.2 | fonts/NeWS | |Sun X11 on SunOS 5.3 | fonts/SPARC | |Hewlett-Packard X11R5 Servers on HPUX-9.0.1 | fonts/HP | |Silicon Graphics X11 Servers | fonts/SGI | |IBM AIX 3.2.5 X11R5 Servers | fonts/IBM | |DEC DECWINDOWS X11 Servers | fonts/DEC | | | | _|_______________________________________________|_____________| _S_o_f_t_W_i_n_d_o_w_s uses the ServerVendor string (see _x_d_p_y_i_n_f_o(_1_X) ) to determine the server to use. If it does not recognise the server the default font directory (HP) is used instead. This should work for many X11R5 servers, but if not, an error message will be displayed when the font is accessed. The font sources (in _f_o_n_t_s/_s_r_c in the SoftWindows installation directory) should then be compiled into a directory such as _f_o_n_t_s/_M_I_T in the SoftWindows installation directory, using the server's font compiler (e.g. bbbbddddffffttttoooossssnnnnffff (1)). xxxxsssseeeetttt ffffpppp++++ [[[[ddddiiiirrrrnnnnaaaammmmeeee]]]] should then be used used to tell the X11 server about these fonts before _S_o_f_t_W_i_n_d_o_w_s is started on future occasions. Another reason font setup may not work is that the SoftWindows font files must be installed visible to the X11 server on which SoftWindows is to be displayed. Otherwise an error will occur when SoftWindows attempts to set up the font directory, as the X11 server cannot 'see' the directory which SoftWindows tells it. The only solution to this problem is to use xxxxsssseeeetttt ffffpppp to tell the X server about the correct directory, or to copy the font files to a directory already used by the X server. MIT style X servers will typically look in /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_m_i_s_c . DDDDUUUUMMMMBBBB TTTTEEEERRRRMMMMIIIINNNNAAAALLLL SSSSUUUUPPPPPPPPOOOORRRRTTTT SoftWindows supports the use of dumb terminals, or compatible X-Windows terminal emulators, in what is called Dumb Terminal mode. This is invoked by running SoftWindows with the argument -term _x, where x is the name of the terminal being used. The terminal type must be one of the supported terminals, files for which are stored in the term directory in the SoftWindows installation directory. In certain cases, the terminal name used here is not the same as that used by the host OS. When this happens, SoftWindows must be invoked with an additional paramter -keymap: SoftWindows2 -term host-term -keymap softwindows-term Page 4 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) where host-term is the host OS's terminal name, and softwindows-term is the name used by SoftWindows. If these do not define the same actual terminal the result is undefined. In addition to the standard key combinations the dumb terminal definitions define a number of special sequences. these allow the user to, for example, exit SoftWindows. Alternatively, the DOS program eeeexxxxiiiittttsssswwwwiiiinnnn will cause an immediate exit from SoftWindows in either X11 or Dumb Terminal mode. DDDDUUUUMMMMBBBB TTTTEEEERRRRMMMMIIIINNNNAAAALLLL RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS _S_o_f_t_W_i_n_d_o_w_s does not support the use of DOS mode graphics, running MS-Windows or any Windows applications in Dumb Terminal mode. Line graphics characters for DOS text video modes are supported wherever possible, but some terminals lack the necessary character shapes; in these cases other characters are used instead. The following terminal types are supported: HP2392, HP2393, HP2394, HP2397, HP700/44, HP700/92 and HP700/94, VT100 and VT200 and compatible (includes the X11-based xterm), Wyse model 60 and compatible, IBM 3151 and ANSI compatible (includes IRIX X11-based iris-ansi terminal). EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT The following environment variables must be set in order that SoftWindows runs correctly. HHHHOOOOMMMMEEEE The user's home directory. Required for access to configuration files at startup. This environment variable is set by the shell and should not be changed by the user. LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE The license file. You should only set this environment variable if you do not have a license for SoftWindows installed on your own machine, but you have a license installed with a license server running on another host on your network. In this case, the environment variable should be set to _p_o_r_t@_h_o_s_t, where ppppoooorrrrtttt is the TCP/IP port number used by the license server, usually 744, and hhhhoooosssstttt is the name of the host on which the license server is running. These variables may be set when running SoftWindows. If DISPLAY is not set, the '-display' option must be used instead. Page 5 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) SSSSPPPPCCCC____BBBBAAAATTTTCCCCHHHH This variable suppresses the panel asking the user to resize the X Window on starting an MS-Windows session. The currently selected size will be used. The value of the variable is not used. DDDDIIIISSSSPPPPLLLLAAAAYYYY To get the default host and display number. For example, 'unix:0.0' is a valid display setting. Usually set up by the X11 initialisation process. LLLLAAAANNNNGGGG To find the message catalog. _S_o_f_t_W_i_n_d_o_w_s looks for the message catalog in _n_l_s/$_L_A_N_G/_s_w_i_n._c_a_t in the SoftWindows installation directory. The default location is _n_l_s/_C/_s_w_i_n._c_a_t in the SoftWindows installation directory. Not applicable for systems not using NLS. You might also want to set the following environment variables, although they are not used by SoftWindows itself. The following variables are also set internally. Although in some cases the behaviour of SoftWindows can be altered by changing these, such deliberate alteration is not recommended: SSSSWWWWIIIINNNN2222HHHHOOOOMMMMEEEE The installation directory of SoftWindows, usually /usr/lib/SoftWindows2 NNNNLLLLSSSSPPPPAAAATTTTHHHH This is used to tell the Native Language Support system (NLS) system about the directories mentioned in LLLLAAAANNNNGGGG above. Not applicable for systems not using NLS. An entry $_S_W_I_N_2_H_O_M_E/_n_l_s/%_L/%_N._c_a_t is prepended to any existing definition of this variable. XXXXUUUUSSSSEEEERRRRFFFFIIIILLLLEEEESSSSEEEEAAAARRRRCCCCHHHHPPPPAAAATTTTHHHH This variable is used to define the location of the app-defaults file SoftWindows must find in order to run. An entry $_S_W_I_N_2_H_O_M_E/%_L/%_N%_S:$_S_W_I_N_2_H_O_M_E/%_N%_S is appended to any existing definition of this variable. LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE This variable defines the locations the license manager software will look in order to find a valid SoftWindows license. An entry $_S_W_I_N_2_H_O_M_E/_F_L_E_X_l_m/_l_i_c_e_n_s_e._d_a_t is appended Page 6 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) to any existing definition of this variable. You will need to set this environment variable yourself if your SoftWindows license is installed with a license server running on another host on your network. See the previous description of LLLLMMMM____LLLLIIIICCCCEEEENNNNSSSSEEEE____FFFFIIIILLLLEEEE in this section for more information. FFFFIIIILLLLEEEESSSS Where a fully-qualified pathname is not given, the filenames and pathnames listed here are relative to the SoftWindows installation directory. This is usually /usr/lib/SoftWindows2. bin/SoftWindows2 The PC emulator executable. sOftWindows SoftWindows X11 resource (app- defaults) file. sys.swin2config Default user configuration MS-WIN-311.hdf Default system hard disk file. windows/* Microsoft Windows 3.1 installation files. term/* Dumb terminal definition files keymap/* Keyboard mapping files nls/C/swin.cat Standard SoftWindows message catalog. fonts/src/spc* Font source files for the video adapter emulation. fonts/*/spc* Pre-compiled font files for Hewlett-Packard, IBM, Sun News, Sun X11R5, DEC and Silicon Graphics X servers. local/* Localisation data for SoftWindows. autoexec.bat, win.ini etc. files to set up keyboards and language data. One directory per keyboard style or language. man/*/* Manual pages. $HOME/.swin2config User configuration file Page 7 (printed 10/17/95) SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) IIIInnnnssssiiiiggggnnnniiiiaaaa SSSSooooffffttttWWWWiiiinnnnddddoooowwwwssss((((1111)))) CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright 1986-1994 Insignia Solutions, Inc. Copyright 1981-1993 Microsoft Corp. OOOORRRRIIIIGGGGIIIINNNN Insignia Solutions, Inc. SSSSEEEEEEEE AAAALLLLSSSSOOOO X(1), xset(1), _S_o_f_t_W_i_n_d_o_w_s _2._0 _U_s_e_r_s _G_u_i_d_e. Page 8 (printed 10/17/95) 
